home *** CD-ROM | disk | FTP | other *** search
/ Creative Computers / Creative Computers CD-ROM, Volume 1 (Legendary Design Technologies, Inc.)(1994).iso / shareware / utilities / icontrace_2.00 / it.doc < prev    next >
Text File  |  1994-11-17  |  15KB  |  578 lines
  1.  
  2.  
  3.                        IconTrace v2.00 User's Manual                 1
  4.  
  5.  
  6.                               IconTrace v2.00
  7.  
  8.                         Copyright © 1993 Peter Stuer
  9.                             All rights reserved
  10.  
  11.                       Release date November 15, 1993
  12.  
  13.                                  FREEWARE
  14.  
  15.                                 User Manual
  16.  
  17.  
  18.      COPYRIGHT NOTICE 
  19.  
  20.      IconTrace software and documentation are Copyright © 1993 by
  21.      Peter Stuer.  All rights reserved.  
  22.  
  23.  
  24.      DISCLAIMER 
  25.  
  26.      IconTrace has proven to be stable in everyday use.  The author
  27.      is not responsible for any loss of data, damages to software or
  28.      hardware that may result directly or indirectly from the use of
  29.      this program.  The author reserves the right to make changes to
  30.      the software or documentation without notice.  
  31.  
  32.  
  33.      PREFACE 
  34.  
  35.      This program is freeware, this means that you can copy it freely
  36.      as long as you don't ask any more money for it than a nominal
  37.      fee for copying.  If you want to distribute this program you
  38.      should keep this document with it.  This program cannot be used
  39.      for commercial purposes without written permission from the
  40.      author.  
  41.  
  42.      None of the files of the IconTrace package may be modified or
  43.      left out without permission of the author. Crunching or achiving
  44.      is allowed only if none of the IconTrace files get modified by
  45.      it.  
  46.  
  47.      Special permission is hereby granted to include IconTrace in
  48.      Public-Domain collections such as Fred Fish's Amiga Library.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63.  
  64.      
  65.  
  66.  
  67.                        IconTrace v2.00 User's Manual                 2
  68.  
  69.  
  70.      Chapter 1 Introduction      
  71.  
  72.      1.1 What is IconTrace ?    
  73.  
  74.          IconTrace is a program that allows you to monitor what the
  75.      icon library is doing when you start a program using the
  76.      Workbench.  It's main use lies in discovering undocumented
  77.      ToolTypes and debugging your existing ToolTypes by watching if
  78.      the program finds them correctly. You are also shown what icons
  79.      your programs look for.  
  80.  
  81.  
  82.      1.2 Features of IconTrace     
  83.  
  84.          Currently the following functions can be monitored: 
  85.  
  86.              FindToolType            GetIcon 
  87.              GetDiskObject           MatchToolValue 
  88.              GetDiskObjectNew        PutDiskObject 
  89.              GetDefDiskObject        PutDefDiskObject 
  90.                                      PutIcon 
  91.  
  92.      You can specify which functions IconTrace should monitor.  
  93.  
  94.      IconTrace saves the trace information it gathers as session
  95.      history. It provides a scrollbar which enables you to scroll
  96.      through the session history.  
  97.  
  98.      IconTrace is also a commodity. You can specify a hotkey to show
  99.      or hide the output window.  
  100.  
  101.      IconTrace can open on any public screen.  
  102.  
  103.  
  104.      1.3 System requirements      
  105.  
  106.          IconTrace should run on any Amiga system with at least 512K
  107.      RAM and one disk-drive. IconTrace requires KickStart v2.04 or
  108.      higher to run. Special care has been taken in the program design
  109.      to make the program work with 68020, 68030 and 68040 processors
  110.      without sacrificing 68000 compatibility.  
  111.  
  112.      IconTrace also requires the ReqTools.library v38 or higher.
  113.      ReqTools is copyright © 1992, 1993 by Nico François.  
  114.  
  115.      IconTrace is KickStart 3.0 compatible and aware. It will show
  116.      you some of the new features available with this version of the
  117.      operating system.  
  118.  
  119.      Should you have any trouble running IconTrace on your machine,
  120.      please write to me with the full specifications of your machine,
  121.      that is KickStart version, model, expansion boards etc...  
  122.  
  123.  
  124.      1.4 About the author and the program  
  125.  
  126.  
  127.  
  128.      
  129.  
  130.  
  131.                        IconTrace v2.00 User's Manual                 3
  132.  
  133.  
  134.          IconTrace has been created using the Macro68 Assembler and
  135.      CygnusEd Professional 3 on an Amiga A3000 25/100 with 10MB
  136.      memory.  The IconTrace documentation was formatted with PRoff.  
  137.  
  138.      If you have suggestions or remarks about this program, or if you
  139.      find any bugs, please let me know.  
  140.  
  141.      When sending in bug reports, please state exactly under what
  142.      circumstances the bug occurred, what equipment was used and what
  143.      happened. If possible also try to give me enough information to
  144.      reproduce the bug. It is very difficult to find bugs when you
  145.      don't know exactly what happened.  
  146.  
  147.      Write to the following address: 
  148.  
  149.              Fido     :  2:292/603.7 (Peter Stuer)
  150.              AmigaNet : 39:120/102.7 (Peter Stuer)
  151.              NLA Net  : 14:200/101.7 (Peter Stuer)
  152.  
  153.              UUCP     : Peter.Stuer@p7.f603.n292.z2.FidoNet.Org
  154.  
  155.              SnailMail: Peter Stuer
  156.                         Beatrijslaan 2 bus 13
  157.                         B-2050 Antwerpen L.O.
  158.                         Belgium - Europe
  159.  
  160.      I will also try to put the latest available version of IconTrace
  161.      on the following BBS (this may change without further notice): 
  162.  
  163.              Great Balls Of Fire BBS 
  164.              ReqTools Support BBS 
  165.              Herman Stevens 
  166.              Lubbeek 
  167.              ADS Distribution HUB 
  168.              ABC Host Belgium 
  169.              AFN Host Belgium 
  170.              Tel. +32-(0)16-64.09.12 
  171.              ZyXEL U1496+ 16800 BPS (N.8.1) v32bis v42bis 
  172.              24-24 h.  
  173.              Fido Node  2:292/603 
  174.              NLA Node  14:200/101.0 
  175.              AmyNet    39:120/102.0 
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.      
  193.  
  194.  
  195.                        IconTrace v2.00 User's Manual                 4
  196.  
  197.  
  198.      Chapter 2 Using IconTrace     
  199.  
  200.          You can be start IconTrace from the CLI/Shell or the
  201.      Workbench.  IconTrace will always check to make sure it is not
  202.      already running. If so, the copy of IT that is already running
  203.      will be notified and its window will open or come to the front.
  204.      The second copy will exit quietly.  
  205.  
  206.  
  207.      2.1 Starting IconTrace from the Shell   
  208.  
  209.          To start IconTrace from the Shell simply type: 
  210.  
  211.              1> IconTrace 
  212.  
  213.      followed by a return. If you want to continue using the Shell
  214.      while IconTrace is running, you need to prepend the Run command
  215.      before IconTrace as follows: 
  216.  
  217.              1> run IconTrace 
  218.  
  219.      If IconTrace is succesful in initializing itself, you see the
  220.      IconTrace window and will start monitoring the icon.library. If
  221.      no window is displayed, consult Appendix A (Troubleshooting) for
  222.      more assistance.  
  223.  
  224.  
  225.      2.2 Shell Startup Options     
  226.  
  227.          IconTrace can be started with various options. If you run
  228.      IconTrace with a questionmark (?) as argument you'll get the
  229.      argument template.  
  230.  
  231.  
  232.      HISTORY 
  233.  
  234.        This option tells IconTrace how many lines of history it
  235.        should keep. Use 0 to disable the history feature. The default
  236.        number of history lines is 256.  
  237.  
  238.      OUTPUT 
  239.  
  240.        With this option you can direct the trace information to some
  241.        other AmigaDOS device of file in addition or in place of the
  242.        information being displayed in the window.  
  243.  
  244.        If you have a debugging terminal attached to the serial port
  245.        you could use 'IconTrace OUTPUT=AUX:' to have all trace
  246.        information appear at the terminal.  
  247.  
  248.        A special symbol is DEBUG. 'OUTPUT=DEBUG' will output all
  249.        trace information to the serial port at 9600 baud.  
  250.  
  251.      WIDTH 
  252.  
  253.        This option specifies the width of the IconTrace output window
  254.  
  255.  
  256.      
  257.  
  258.  
  259.                        IconTrace v2.00 User's Manual                 5
  260.  
  261.  
  262.        in pixels. By default, IconTrace will open a window that is as
  263.        wide as the visible width of the public screen it is appearing
  264.        on.  
  265.  
  266.      HEIGHT 
  267.  
  268.        This option specifies the height of the IconTrace output
  269.        window in screen lines. By default, IconTrace will open a
  270.        window that is as high as the visible height of the public
  271.        screen it is appearing on, without overlapping the title bar.  
  272.  
  273.      SCREEN 
  274.  
  275.        If you do not use this option, IconTrace will open on the
  276.        default public screen which is most of the times the Workbench
  277.        screen.  IconTrace will try to open on the public scr